SGSetSoundInputParameters(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 6 - Sequence Grabber Channel Components / Sequence Grabber Channel Components Reference

Functions / Configuration Functions for Sound Channel Components

SGSetSoundInputParameters
The SGSetSoundInputParameters function allows the sequence grabber to set some parameters that relate to sound recording.
pascal ComponentResult SGSetSoundInputParameters (SGChannel c,
                                        short sampleSize,
                                        short numChannels,
                                        OSType compressionType);
c
Identifies the channel connection for this operation.
sampleSize

Specifies the number of bits in each sound sample. This field is set to 8 for 8-bit sound; it is set to 16 for 16-bit sound.
numChannels

Indicates the number of sound channels to be used by the sound sample. This field is set to 1 for monaural sounds; it is set to 2 for stereo sounds.
compressionType

Describes the format of the sound data. The following values are supported:
'raw '
Sound samples are uncompressed, in offset-binary format (that is, sample data values range from 0 to 255).
'MAC3'
Sound samples have been compressed by the Sound Manager at a ratio of 3:1.
'MAC6'
Sound samples have been compressed by the Sound Manager at a ratio of 6:1.

DESCRIPTION
Sequence grabbers may use the SGSetSoundInputParameters function to control many parameters relating to sound recording. All of the sound parameters support two special values. If any of these parameters are set to 0, your channel should not change the current value of that parameter. If any are set to -1, return that parameter to its default value.
If your sound device cannot support a specified parameter value, return an appropriate Sound Manager result code.

RESULT CODES
Sound Manager errors